Skip to main content
POST
/
api
/
v2
/
products
Create a product [V2]
curl --request POST \
  --url https://api.loops.fi/api/v2/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "thumbnailUrl": "<string>",
  "images": [
    "<string>"
  ],
  "amountType": "FIXED",
  "priceAmount": 1.5,
  "minimumAmount": 1.5,
  "presetAmount": 123,
  "recurringInterval": "month",
  "priceCurrency": "USD",
  "metadata": {}
}'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "thumbnailUrl": "<string>",
  "images": [
    "<string>"
  ],
  "recurringInterval": "month",
  "amountType": "FIXED",
  "priceAmount": "<string>",
  "minimumAmount": "<string>",
  "presetAmount": "<string>",
  "priceCurrency": "<string>",
  "status": "ACTIVE",
  "metadata": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "merchantId": "<string>"
}

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Body

application/json
name
string
required

Product name

Required string length: 1 - 200
description
string

Product description

Maximum length: 1000
thumbnailUrl
string<uri>

Product thumbnail image URL

images
string<uri>[]

Array of product image URLs

amountType
enum<string>
default:FIXED

Amount type

Available options:
FIXED,
CUSTOM,
FREE
priceAmount
number

Price amount (required for FIXED type)

Required range: x >= 0.5
minimumAmount
number

Minimum amount (for CUSTOM type)

Required range: x >= 0.5
presetAmount
number

Preset amount (for CUSTOM type)

Required range: x <= 10000
recurringInterval
enum<string>

Recurring interval for subscriptions

Available options:
month,
year
priceCurrency
string
default:USD

Price currency

metadata
object

Additional product metadata

Response

Default Response

id
string
required

Unique product identifier

name
string
required

Product name

amountType
enum<string>
required

Amount type

Available options:
FIXED,
CUSTOM,
FREE
priceCurrency
string
required

Price currency

status
enum<string>
required

Product status

Available options:
ACTIVE,
DRAFT,
INACTIVE
createdAt
string<date-time>
required

Product creation time

updatedAt
string<date-time>
required

Product last update time

merchantId
string
required

Merchant ID

description
string

Product description

thumbnailUrl
string<uri>

Product thumbnail image URL

images
string<uri>[]

Array of product image URLs

recurringInterval
enum<string>

Recurring interval for subscriptions

Available options:
month,
year
priceAmount
string

Price amount as string (required for FIXED type)

minimumAmount
string

Minimum amount as string (for CUSTOM type)

presetAmount
string

Preset amount as string (for CUSTOM type)

metadata
object

Additional product metadata

I